home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / util / blank / AntiBlanker.readme < prev    next >
Text File  |  2001-05-03  |  10KB  |  243 lines
  1. Short:    A tool that disables your screen blanker when certain tasks are running
  2. Author:   Ghandi <ghandi@cremlinsoftware.org> and Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  3. Uploader: Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  4. Type:     util/blank
  5. Replaces: AntiBlanker.lha
  6. Requires: OS3.x and at least a 68020
  7.  
  8. ****************************************************************************
  9. * IF YOU STILL REQUIRE OS2.x SUPPORT, V1.1 IS AVAILABLE FROM OUR WWW SITE! *
  10. ****************************************************************************
  11.  
  12. Why was it written?
  13. ~~~~~~~~~~~~~~~~~~~
  14. Because the screen blanker we were using would eat up too much CPU time when
  15. we were trying to burn CDRs thus ruining them, and we kept forgetting to
  16. disable it beforehand, so we thought we would get our Amiga to do it for us.
  17.  
  18.  
  19. How do I run AntiBlanker from Workbench?
  20. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21. Just double click on the AntiBlanker icon.  In order to tell AntiBlanker
  22. what tasks to look out for you must setup it's tool types as follows:
  23.  
  24. DELAY=<the delay between checks (in 1/50ths of a second)>
  25. BLANKCODE=<the blank key code, see below>
  26. BLANKQUALIFIER=<the blank qualifier, see below>
  27. TASK=<the task name you would like to disable your screen blanker for>
  28.  
  29. e.g.:
  30.  
  31. DELAY=6000
  32. BLANKCODE=0x0062
  33. BLANKQUALIFIER=0x0004
  34. TASK=MakeCD
  35. TASK=PalomaTV
  36.  
  37. The above would disable your screen blanker when ever MakeCD or PalomaTV are
  38. running, and it will check to see if they are running every 2 minutes
  39. (6000/50/60 = 2 minutes), but
  40.  
  41.  
  42. How do I run AntiBlanker from the CLI?
  43. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44. Type the following at a CLI prompt:
  45.  
  46. <Path>AntiBlanker <Config #1> <Config #2> ... <Config #n>
  47.  
  48. Where <Config #n> are any number of configuration files, AntiBlanker will
  49. automatically append them all together.  The format of the configuration
  50. files are as follows:
  51.  
  52. Line1      the delay between check (in 1/50ths of a second)
  53.            same as DELAY tooltype
  54. Line2      the blank key code (see below)
  55.            same as BLANKCODE tooltype
  56. Line3      the blank qualifier (see below)
  57.            same as BLANKQUALIFIER tooltype
  58. Line4 .. x the task name you would like to disable your screen blanker for
  59.            same as TASK tooltype
  60.  
  61. nb. when using multiple configuration files, AntiBlanker uses the DELAY,
  62.     BLANKCODE and BLANKQUALIFIER from the last configuration file specified.
  63.  
  64.  
  65. What are the blank code and blank qualifier?
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67. AntiBlanker works by putting 'fake' input events onto the input chain, thus
  68. fooling your screen blanker into thinking you've pressed a key when you
  69. haven't.  Versions before 0.4 used the 'Control' <Ctrl> key for this purpose
  70. as we thought it was least likely to cause any conflicts, unfortunately we
  71. did not fill in the input event with a single <Ctrl>, but instead we
  72. accidentally set it to <Ctrl> + <'> and this would produce 'trash' in a
  73. shell window and in some software.
  74.  
  75. As of version 0.5 you can specify the blank code and blank qualifier (see
  76. above), this allows you to program AntiBlanker to 'fool' the system with any
  77. key you like.  You can specify the codes as hex or decimal by copying them
  78. exactly from the tables below (the tables are not complete, but should get
  79. you started).
  80.  
  81. Blank codes
  82. ~~~~~~~~~~~
  83. Key               Hex Code      Decimal Code
  84. ---               --------      ------------
  85. Left Shift        0x0060        96
  86. Right Shift       0x0061        97
  87. Caps Lock         0x0062        98
  88. Control           0x0063        99
  89. Left Alt          0x0064        100
  90. Right Alt         0x0065        101
  91. Left Amiga        0x0066        102
  92. Right Amiga       0x0067        103
  93.  
  94. nb. the above blank codes work on our A1200, although they may be slightly
  95.     different for other Amigas (and possibly foreign keyboards), if you get
  96.     'trash' in a shell window while using AntiBlanker try a different code.
  97.  
  98. Blank qualifiers
  99. ~~~~~~~~~~~~~~~~
  100. Key               Hex Code      Decimal Code
  101. ---               --------      ------------
  102. Left Shift        0x0001        1
  103. Right Shift       0x0002        2
  104. Caps Lock         0x0004        4
  105. Control           0x0008        8
  106. Left Alt          0x0010        16
  107. Right Alt         0x0020        32
  108. Left Amiga        0x0040        64
  109. Right Amiga       0x0080        128
  110.  
  111. If you find one of the above keys conflicts with your software try another.
  112.  
  113. nb. the Caps Lock codes do not appear to actually affect the status of
  114.     Caps Lock itself.
  115.  
  116.  
  117. Which blankers work with AntiBlanker?
  118. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  119. AntiBlanker has been tested and proven to work with the following screen
  120. blankers, although it should work with almost any screen blanker.  If you
  121. have tested it with a blanker not listed, please let us know the results so
  122. that we can update the list.
  123.  
  124. Blanker                           AntiBlanker version  Comments
  125. -------                           -------------------  --------
  126. extras:tools/commodities/Blanker  0.1+
  127. util/cdity/mcx280.lha             0.1+
  128. util/blank/ASwarmII2_0.lha        0.2+
  129. util/blank/Auror15a.lha           0.2+
  130. util/blank/BeyondTheDark.lha      0.2+
  131. util/blank/Blanker2.6.lha         0.2+
  132. util/blank/DesktopMAGIC.lha       0.2+
  133. util/blank/DPMSManager.lha        0.2+
  134. util/blank/GBlanker36.lha         0.2, 0.3, 0.5+
  135. util/blank/GBlanker36_020.lha     0.2, 0.3, 0.5+
  136. util/blank/FlyingToasters.lha     0.2+
  137. util/blank/MTX.lha                0.2+                 MTX 1.5+ required
  138. util/blank/ShadowMaster.lha       0.2+
  139. util/blank/StarBlanker.lha        0.2+
  140. util/blank/SwazBlanker240.lha     0.2+
  141.  
  142.  
  143. Miscellaneous notes
  144. ~~~~~~~~~~~~~~~~~~~
  145. Task names are CASE SENSITIVE, you can find out the name of task via a tool
  146. such as Scout.
  147.  
  148. To stop AntiBlanker, send it a CTRL-C signal either via the Break/BreakName
  149. programs or by a tool such as Scout.  Please note that AntiBlanker will not
  150. end immediately but after it's next loop.
  151.  
  152. To get the best performance out of AntiBlanker (so that it uses the least
  153. CPU time), put the tasks that you use most at the bottom of the tool type
  154. list (or configuration files).  Due to the way AntiBlanker stores the task
  155. names internally it actually checks for the tasks in the reverse order to
  156. the how you specify them.
  157.  
  158.  
  159. Registration and contacting us
  160. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  161. AntiBlanker is 'email ware', this means that if you use it then you must
  162. send us an email.  As you can see this is a very small cost to pay.
  163.  
  164. Also feel free to visit our website at http://www.cremlinsoftware.org/ it
  165. hosts all the latest versions of our software (including BETA releases).
  166.  
  167.  
  168. History
  169. ~~~~~~~
  170.  
  171. Version   Date        Comments
  172.  
  173. 0.1       15.06.1998  · First public release.
  174.  
  175. 0.2       15.06.1998  · Fixed AntiBlanker so that it works with
  176.                         Garshneblanker.
  177.                         [Luca 'Hexaae' Longone]
  178.  
  179. 0.3       05.09.1998  · Fixed an Enforcer hit that was caused by our linked
  180.                         list class.
  181.                         [Luca 'Hexaae' Longone]
  182.  
  183. 0.4       14.09.1998  · Added user definable blank key.
  184.                       · Altered the code so it sends a KEY_UP event instead
  185.                         of a KEY_DOWN.  This should reduce the amount of
  186.                         conflicts with existing software.
  187.  
  188. 0.5 BETA  15.09.1998  · Added the BlankCodeFinder program to the AntiBlanker
  189.                         package.
  190.                       · Changed user definable blank key so that it is
  191.                         specified as a CODE and QUALIFIER, instead of just a
  192.                         QUALIFIER.
  193.                       · Altered the code so it sends a KEY_DOWN event like
  194.                         0.3 did, as we had forgotten this was necessary for
  195.                         Garshneblanker compatibility (oops).
  196.  
  197. 1.0       15.02.2000  · Finally fixed the Enforcer hit on startup (that only
  198.                         took 1½ years).
  199.                         [Luca 'Hexaae' Longone]
  200.                       · Configuration file(s) are now closed properly.
  201.                       · Added CTRL-C support.
  202.                       · A number of internal optimisations and recompiled
  203.                         with the new OS3.5 includes.
  204.  
  205. 1.1       05.03.2000  · Our linked list class has been enhanced and cleaned
  206.                         up for one of our other projects, so we have
  207.                         recompiled AntiBlanker to accomodate the new class.
  208.                         nb. no real changes have been made to the program
  209.                             itself.
  210.  
  211. 1.2       04.06.2000  · General cleanup of the code which has reduced the
  212.                         executable size slightly and AntiBlanker should use
  213.                         ever so slightly less memory.
  214.                       · AntiBlanker does now work with MTX, thanks to it's
  215.                         author for rewritting the checking code :-)
  216.                       · We have moved from HiSOFT C++ to StormC, basically
  217.                         because StormC is still being developed.
  218.  
  219. 1.3       10.09.2000  · A few minor optimisations generated by work on our
  220.                         other projects.
  221.  
  222. 1.4       20.12.2000  · Recompiled with StormC v4; saved a few bytes.
  223.  
  224. 1.5       05.03.2001  · Version string is also handled correctly by DOpus 5.
  225.                       · Configuration file(s) are handled the same as tool
  226.                         types (keeps things standardised).
  227.                       · Recompiled with stormamiga.lib v45 beta 5; the
  228.                         executable is a few bytes bigger but it is a lot
  229.                         neater infact this will more than likely be the last
  230.                         release.
  231.  
  232.  
  233. ============================= Archive contents =============================
  234.  
  235. Original  Packed Ratio    Date     Time    Name
  236. -------- ------- ----- --------- --------  -------------
  237.     9364    5724 38.8% 05-Mar-01 19:45:00  AntiBlanker
  238.       35      35  0.0% 05-Mar-01 19:45:00  AntiBlanker.cfg
  239.      580     281 51.5% 05-Mar-01 19:45:00  AntiBlanker.info
  240.     9651    3581 62.8% 05-Mar-01 19:45:00  AntiBlanker.readme
  241. -------- ------- ----- --------- --------
  242.    19630    9621 50.9% 06-Mar-101 01:25:14   4 files
  243.